home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / postgres / postgre2.z / postgre2 / ref / postquel / load < prev    next >
Encoding:
Text File  |  1992-08-27  |  1.9 KB  |  62 lines
  1. .\" XXX standard disclaimer belongs here....
  2. .\" $Header: /private/postgres/ref/postquel/RCS/load,v 1.5 1992/07/14 05:54:17 ptong Exp $
  3. .SP LOAD COMMANDS 6/14/90
  4. .XA 2 Load
  5. .uh NAME
  6. .lp
  7. load \*- dynamically load an object file
  8. .uh SYNOPSIS
  9. .lp
  10. .(l
  11. \fBload \fR "filename"
  12. .)l
  13. .uh DESCRIPTION
  14. .lp
  15. .b Load
  16. loads an object (or ".o") file into \*(PP's address space.  Once a file
  17. is loaded, all functions in that file can be accessed.  This function is
  18. used in support of ADT's.
  19. .lp
  20. If a file is not loaded using the 
  21. .b load
  22. command, the file will be loaded automatically the first time the function
  23. is called by \*(PP.
  24. .b Load
  25. can also be used to reload an object file if it has been edited and recompiled.
  26. Only objects created from C language files are supported at this time.
  27. .uh EXAMPLE
  28. .lp
  29. .nf
  30. .ft C
  31. /* Load the file /usr/postgres/demo/circle.o */
  32.  
  33. load "/usr/postgres/demo/circle.o"
  34. .ft
  35. .fi
  36. .sp
  37. .uh CAVEATS
  38. .sp
  39. Functions in loaded object files should not call functions in other object
  40. files loaded through the 
  41. .b load
  42. command, meaning, for example, that all functions in file A should call
  43. each other, functions in the standard or math libraries, or in \*(PP itself.
  44. They should not call functions defined in a different loaded file B.  This is
  45. because if B is reloaded, the \*(PP loader is not "smart" enough to relocate
  46. the calls from the functions in A into the new address space of B.  If B is
  47. not reloaded, however, there will not be a problem.
  48. .lp
  49. On diskless platforms or when running across NFS,
  50. .b load
  51. can take two or three minutes or more, depending on network traffic.  On
  52. diskful platforms,
  53. .b load
  54. takes from a few seconds on Suns and Sparcs to several minutes on DECstations.
  55. .lp
  56. On DECstations, you must use the "-G O" option when compiling object files to
  57. be loaded.
  58. .lp
  59. Note that if you are porting \*(PP to a new platform, the
  60. .b load
  61. command will have to work in order to support ADT's.
  62.